Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update live code to live demos in 17-live.md #1558

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

ndporter
Copy link
Contributor

@ndporter ndporter commented Jun 9, 2023

  1. Replace "coding" in most instances with "demo" or related words to make more general
  2. Update line 33 to reflect both online and in-person workshops
  3. Remove wikipedia "live coding" link as it refers to live coding as a research or artistic tool, but doesn't reference pedagogy at all
  4. Added callout on live coding/demos

1. Replace "coding" in most instances with "demo" or related words to make more general
2. Update line 33 to reflect both online and in-person workshops
3. Remove wikipedia "live coding" link as it refers to live coding as a research or artistic tool, but doesn't reference pedagogy at all
4. Added callout on live coding/demos
@github-actions
Copy link

github-actions bot commented Jun 9, 2023

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries/instructor-training/compare/md-outputs..md-outputs-PR-1558

The following changes were observed in the rendered markdown documents:

 17-live.md | 56 ++++++++++++++++++++++++++++++++++++--------------------
 md5sum.txt |  2 +-
 2 files changed, 37 insertions(+), 21 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2023-08-02 13:14:34 +0000

github-actions bot pushed a commit that referenced this pull request Jun 9, 2023
Copy link
Contributor

@brownsarahm brownsarahm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I picked at a few places specifically, but I actually think that we should use "demonstration" throughout because full words are more inclusive than shortenings for non native english speakers, I think.

It's also more consistent to use the exact same term throughout instead of two forms of it.

along. This section explains how it works, why we use it, and
gives general tips for an effective participatory live coding presentation. We will
gives general tips for an effective participatory live demo presentation. We will
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
gives general tips for an effective participatory live demo presentation. We will
gives general tips for an effective participatory live demonstration. We will

"demo presentation" reads funny to me

@@ -174,9 +190,9 @@ This exercise should take about 25 minutes.

:::::::::::::::::::::::::::::::::::::::: keypoints

- Live coding forces the instructor to slow down.
- Live demos forces the instructor to slow down.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Live demos forces the instructor to slow down.
- Live demonstration forces the instructor to slow down.

or live demo maybe, but "live demos" feels like a mismatch of plurality?

@@ -107,7 +123,7 @@ Many error messages are obscure and not written with novices in mind. Continue t

## Compare and Contrast

Watch this first participatory live coding demo video: [https://youtu.be/bXxBeNkKmJE][live-coding-bad]
Watch this first participatory live demo video: [https://youtu.be/bXxBeNkKmJE][live-coding-bad]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is actually code, so I think here, live "coding" is actually more accurate and we should augment the exercise with reflection on what we can learn from this that applies to non-coding contexts

and continuous feedback (their code either works or fails with an error message). It is
Live demos fits well into the practice-feedback model we have been discussing - by providing
learners with continuous opportunities for practice (every time they type a line of code or perform a procedure)
and continuous feedback (their attempt either works or fails with an error message). It is
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the "error message" part may not translate to non-coding contexts, but i'm not sure what the best fix is here.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Error messages defnitely come up in non-coding contexts IME.

Live coding fits well into the practice-feedback model we have been discussing - by providing
learners with continuous opportunities for practice (every time they type in a line of code)
and continuous feedback (their code either works or fails with an error message). It is
Live demos fits well into the practice-feedback model we have been discussing - by providing
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Live demos fits well into the practice-feedback model we have been discussing - by providing
Live demonstration fits well into the practice-feedback model we have been discussing - by providing

i think using the full work is better for non native english speakers, but would accept the singular of the shortcut

github-actions bot pushed a commit that referenced this pull request Aug 2, 2023
@ha0ye
Copy link
Contributor

ha0ye commented Nov 16, 2023

@brownsarahm - I am internally amused about people reading "live demo" and then expecting to see "Carpentries Live Demolitions", but your suggestion is excellent!

but you don't need to be a programmer or know how to code at all
to integrate live demonstrations in your teaching.
Many of our lessons on tools like spreadsheets and OpenRefine
include no coding at all, and similar models are widely used

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not entirely correct, although I see the distinction of these two lessons. Both use some use of functions. Might change it to "Some lessons might not include coding..."

@ragamouf
Copy link
Contributor

Following today's discussion in the trainer meeting, my consideration into this change comes to this:
If we teach a cohort of trainees with no experience coding, programming, developing software, then it is up to us to explain the place of live coding in our pedagogy, and our emphasis on "participatory live coding". I don't agree with the wholesale change to replace 'coding' with 'demonstration' or other general presentation forms because it takes the learner away from the new mental model that we are teaching, which is associated explicitly with programming skills. When words and concepts are unfamiliar to learners, we can teach them to embrace the discomfort.

@JCSzamosi
Copy link
Contributor

The reason I don't fully agree with this is that we do, in fact, have quite a bit of curriculum that does not involve coding. The open refine and spreadsheet lessons in the DC and LC curricula, at least. I would even go so far as to say that the Git lessons don't strictly speaking teach coding, but rather interactively interacting with Git on the command line.

The point, as I understand it, is not to avoid the word "coding" because it might be unfamiliar or intimidating, but to specifically be inclusive of people who are teaching those lessons, and to avoid confusion by making it clear that the live participatory stuff that we do is not limited to coding.

@brownsarahm
Copy link
Contributor

I really appreciate @ragamouf's comment

When words and concepts are unfamiliar to learners, we can teach them to embrace the discomfort.

I propose that we take a careful read through how we are framing things in this episode that we always do "participatory live demonstration" and that it is mostly "participatory live coding".

We want to include people who want to teach data organization in spreadsheets or cleaning with openrefine, but not affirm people's fear of coding. We teach in this lesson about meeting our learners where they are and encouraging them to use these tools even if they are afraid, I think we need to keep modeling that here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants